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Foreword 



id , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.601: "Configuration Management (CM); Basic CM Integration Reference Point (IRP); Requirements" 

32.602: "Configuration Management (CM); Basic CM Integration Reference Point (IRP); Information 

Service (IS)" 

32.606: "Configuration Management (CM); Basic CM Integration Reference Point (IRP): Solution 

Set (SS) definitions" 

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality of Service (QoS). The CM actions are 
initiated either as single actions on single NEs of the 3G network, or as part of a complex procedure involving actions 
on many resources/objects in one or several NEs. 
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Scope 



The purpose of this document is to define the mapping of the Basic CM IRP: IS (see 3GPP TS 32.602 [8]) to the 
protocol specific details necessary for implementation of this IRP in a CORB A/IDL environment and in a 
SOAP/WSDL environment. 

This document defines NRM independent data types and methods. 

This Solution Set specification is related to 3GPP TS 32.602 V11.0.X. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

For a specific reference, subsequent revisions do not apply. 

For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[4] 3GPP TS 32.306: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Solution Set (SS) definitions". 

[5] 3GPP TS 32.311: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirement". 

[6] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[7] 3GPP TS 32.600: "Telecommunication management; Configuration Management (CM); Concept 

and high-level requirements". 

[8] 3GPP TS 32.602: "Telecommunication management; Configuration Management (CM); Basic CM 

Integration Reference Point (IRP) Information Service (IS)". 

[9] 3GPP TS 32.666: "Telecommunication management; Configuration Management (CM); Kernel 

CM Integration Reference Point (IRP): Solution Set (SS) definitions". 

[10] OMG Notification Service, Version 1.0. 

[II] W3C SOAP 1 . 1 specification ( http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) 
[12] W3C WSDL 1.1 specification ( http://www.w3 .org/TR/200 l/NOTE-wsdl-200 1 03 1 5) 
[13] W3C XPath 1.0 specification ( http://www.w3.org/TR/1999/REC-xpath-19991 1 16) 
[14] W3C SOAP 1.2 specification ( http://www.w3.org/TR/soapl2-partl/) 
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3 Definitions and abbreviations 

3.1 Definitions 

For terms and definitions please refer to 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 3GPP TS 32.600 [7] and 
3GPPTS 32.602 [8]. 



IRP document version number string 

The IRP document version number (sometimes called "IRPVersion" or "SS version number") string is used to 
identify this specification. The string is derived using a rule described in 3GPP TS 32.311 [5], 

This string (or sequence of strings, if more than one version is supported) is returned in getBasicCmlRPVersion 
method. 



3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

DN Distinguished Name 

IS Information Service 

IDL Interface Definition Language (OMG) 

IRP Integration Reference Point 

MO Managed Object 

MOC Managed Object Class 

NRM Network Resource Model 

OMG Object Management Group 

SS Solution Set 

WSDL Web Service Description Language 



4 Solution Set Definitions 

This specification defines the following 3GPP Basic CM IRP Solution Set Definitions: 

Annex A provides the CORBA Solution Set. 
Annex B provides the SOAP Solution Set. 
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Annex A (normative): 
CORBA Solution Set 



This annex specifies the CORBA Solution Set for the IRP whose semantics are specified in 3GPP TS 32.602 [8]. 

A.1 Architectural features 

The overall architectural feature of Basic Configuration Management IRP is specified in 3GPP TS 32.602 [8]. 
This clause specifies features that are specific to the CORBA SS. 

A.1 .1 Syntax for Distinguished Names and Versions 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [3]. 
The version of this IRP is represented as a string (see also clause 3.1). 

A.1 .2 IRP document version number string 

The IRP document version number (sometimes called "IRPVersion" or "SS version number") string is used to identify 
this specification. The string is derived using a rule described in 3GPP TS 32.312: [6]. 

This string (or sequence of strings, if more than one version is supported) is returned in getBasicCmlRPVersion 
method. 



A. 1.3 Filter language 



The filter language used in the SS is the Extended Trader Constraint Language (see OMG Notification Service [10]). 
IRP Agents may throw a FilterComplexityLimit exception when a given filter is too complex. However, for 3GPP 
Release 99 an "empty filter" shall be used i.e. a filter that satisfies all MOs of a scoped search (this does not affect the 
filter for notifications as defined in the Notification IRP - see 3GPP TS 32.306 [4]). 
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A.2 Mapping 

A.2.1 General mappings 

The IS parameter name managedObjectlnstance is mapped into DN. 

Attributes modelling associations as defined in the NRM (here also called "reference attributes") are in this SS mapped 
to attributes. The names of the reference attributes in the NRM are mapped to the corresponding attribute names in the 
MOC. When the cardinality for an association is 0..1 or 1..1 the datatype for the reference attribute is defined as an 
MOReference. The value of an MO reference contains the distinguished name of the associated MO. When the 
cardinality for an association allows more than one referred MO, the reference attribute will be of type 
MOReferenceSet, which contains a sequence of MO references. 

If a reference attribute is changed, an AttributeValueChange notification (see TS 32.666 [9]) is emitted. 



A.2. 2 Operation mapping 



The Basic CM IRP: IS (see 3GPP TS 32.602 [8]) defines semantics of operation visible across the Basic Configuration 
Management IRP. Table A.2.2 indicates mapping of these operations to their equivalents defined in this SS. 

Table A.2.2: Mapping from IS Operation to SS equivalents 



IS Operation 
(3GPP TS 32.602 [8]) 


SS Method 


Qualifier 


getMoAttributes 


BasicCmlrpOperations::find_managed_objects 
BasicCmlnformationlterator::next_basic_cm_informations 


M 


getContainment 


BasicCmlrpOperations::find_managed_objects 
BasicCmlnformationlterator::next_basic_cm_informations 


O 


cancelOperation 


BasicCmlnformationlterator::destroy 


O 


createMo 


BasicCmlrpOperations::create_managed_object 


O 


deleteMo 


BasicCmlrpOperations::delete_managed_objects 

DeleteResultlterator::next_basic_cm_informations 

DeleteResultlterator::next_delete_errors 


O 


setMoAttributes 


BasicCmlrpOperations::modify_managed_objects 
ModifyResultlterator::next_basic_cm_informations 
ModifyResultlterator::next_modification_errors 


O 
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A.2.3 Operation parameter mapping 



The Basic CM IRP: IS (see 3GPP TS 32.602 [8]) defines semantics of parameters carried in operations across the Basic 
Configuration Management IRP. Tables A.2.3. 1 through A. 2. 3. 6 indicate the mapping of these parameters, as per 
operation, to their equivalents defined in this SS. 

The SS operation find_managed_objects is equivalent to the IS operation getMoAttributes when called with 
ResultContents set to NAMES_AND_ATTRIBUTES. Iterating the BasicCmlnformationlterator is used to fetch the 
result. 

Table A.2.3. 1 : Mapping from IS getMoAttributes parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


invokeldentifier 


- (No equivalence) 


- 


invokeldentifierOut 


Return value of type BasicCmlnformationlterator 


M 


baseObjectl nstance 


GenericlRPManagementConstDefs::DN base_object 


M 


scope 


SearchControl search_control (SearchControl.type and 
SearchControl. level) 


M 


filter 


SearchControl search_control (SearchControl.filter) 


M 


attributeListln 


AttributeNameSet requested_attributes 


M 


managedObjectClass 

managedObjectlnstance 

attributeListOut 


Return value of type BasicCmlnformationlterator - parameter out 
ResultSet fetched_elements of method next_basic_cm_informations 


M 


status 


Exceptions: 

FindManagedObjects, 

GenericlRPManagementSystem::lnvalidParameter, 

UndefinedMOException, 

Illegal DNFormatException, 

UndefinedScopeException, 

HlegalScopeTypeException, 

NlegalScopeLevelException, 

Illegal FilterFormatException, 

FilterComplexityLimit 


M 



The SS operation find_managed_objects is equivalent to the IS operation getContainment when called with 
ResultContents set to NAMES. Iterating the BasicCmlnformationlterator is used to fetch the result. 
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Table A.2.3.2: Mapping from IS getContainment parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


invokeldentifier 


- (No equivalence) 


- 


invokeldentifierOut 


Return value of type BasicCmlnformationlterator 


M 


baseObjectl nstance 


GenericlRPManagementConstDefs::DN base_object 


M 


scope 


SearchControl search_control (SearchControl.type and SearchControl. level) 


O 


Not specified in IS 


SearchControl search_control (SearchControl.filter) 


M 


containment 


Return value of type BasicCmlnformationlterator - parameter out ResultSet 
fetched_elements of method next_basic_cm_informations 


M 


status 


Exceptions: 

FindManagedObjects, 

GenericlRPManagementSystem::OperationNotSupported, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported, 

UndefinedMOException, 

INegalDNFormatException, 

UndefinedScope Exception, 

INegalScopeType Exception, 

INegalScopeLevelException, 

UlegalFilterFormatException, 

FilterComplexityLimit 


M 



Table A.2.3.3: Mapping from IS cancelOperation parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


invokeldentifier 


- (Not applicable, the BasicCmlnformationlterator instance identifies the ongoing 
operation) 


M 


status 


Exceptions: 

GenericlRPManagementSystem::OperationNotSupported, 

DestroyException 


M 



Table A.2.3.4: Mapping from IS createMo parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managedObjectClass 
managedObjectlnstance 


GenericlRPManagementConstDefs::DN object_name 


M 


referenceObjectl nstance 


GenericlRPManagementConstDefs::DN reference_object 


O 


attributeListln 
attributeListOut 


GenericlRPManagementConstDefs::MoAttributeSet attributes 


M 


status 


AttributeErrorSeq attribute_errors 

Exceptions: 

CreateManagedObject, 

GenericlRPManagementSystem::OperationNotSupported, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

UndefinedMOException, 

INegalDNFormatException, 

DuplicateMO, 

CreateNotAllowed, 

ObjectClassMismatch, 

NoSuchObjectClass, 

ParentObjectDoesNotExist 


M 
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Table A.2.3.5: Mapping from IS deleteMo parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


baseObjectl nstance 


GenericlRPManagementConstDefs::DN base_object 


M 


scope 


SearchControl search_control (SearchControl.type and SearchControl. level) 


M 


filter 


SearchControl search_control (SearchControl.filter) 


M 


deletionList 


Return value of type DeleteResultlterator - parameter out ResultSet 
fetched_elements of method next_basic_cm_informations 


M 


status 


Return value of type DeleteResultlterator - parameter out DeleteErrorSeq 

fetched_delete_errors of method next_delete_errors 

Exceptions: 

DeleteManagedObjects, 

GenericlRPManagementSystem::OperationNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

UndefinedMoException, 

Illegal DNFormatException, 

UndefinedScopeException, 

HlegalScopeTypeException, 

HlegalScopeLevelException, 

Illegal FilterFormatException, 

FilterComplexityLimit 


M 



Table A.2.3.6: Mapping from IS setMoAttributes parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


baseObjectl nstance 


GenericlRPManagementConstDefs::DN base_object 


M 


scope 


SearchControl search_control (SearchControl.type and SearchControl. level) 


M 


filter 


SearchControl search_control (SearchControl.filter) 


M 


modificationList 


AttributeModificationSet modifications 


M 


modificationListOut 


Return value of type ModifyResultlterator - parameter out ResultSet 
fetched_elements of method next_basic_cm_informations 


M 


status 


Return value of type ModifyResultlterator - parameter out 

ModifyAttributeErrorsSeq fetched_modify_errors of method 

next_modify_errors 

Exceptions: 

ModifyManagedObjects, 

GenericlRPManagementSystem::OperationNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

UndefinedMoException, 

HlegalDNFormatException, 

UndefinedScopeException, 

HlegalScopeTypeException, 

HlegalScopeLevelException, 

Illegal FilterFormatException, 

FilterComplexityLimit 


M 
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A.3 Solution Set definitions 
A.3.1 IDL definition structure 

Clause A. 3. 2 defines the constants and types used by the Basic CM IRP. 

Clause A. 3. 3 defines the operations which are performed by the Basic CM IRP agent. 
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A.3.2 IDL specification "BasicCMIRPConstDefs.idl" 

//File: BasicCMIRPConstDefs.idl 

iifndef _BASIC_CM_IRP_CONST_DEFS_IDL_ 
#define _BASIC_CM_IRP_CONST_DEFS_IDL_ 

#include <GenericIRPManagementConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: BasicCMIRPConstDefs 

This module contains commonly used definitions for BasicCMIRP. 



*/ 

module BasicCMIRPConstDefs 

{ 

* Defines the name of a Managed Object Class 

*/ 

typedef string MOClass; 

/ * * 
k 

* In this version the only allowed filter value is "TRUE" i.e. a filter that 

* matches everything. 
*/ 

typedef string Filter; 

/** 

* ResultContents is used to tell how much information to get back 

* from the f ind_managed_objects operation. 
* 

* NAMES: Used to get only Distinguished Name 

* for MOs. 

* The name contains both the MO class 

* and the names of all superior objects in the naming 

* tree . 
* 

* NAMES_AND_ATTRIBUTES : Used to get both NAMES plus 

* MO attributes (all or selected) . 
*/ 

enum ResultContents 

{ 

NAMES, 

NAMES AND ATTRIBUTES 



/ -k-k 

* ScopeType defines the kind of scope to use in a search 

* together with SearchControl . level, in a SearchControl value. 

* SearchControl . level is always >= . If a level is bigger than the 

* depth of the tree there will be no exceptions thrown. 
*/ 

enum ScopeType 

{ 

BASE_0NLY, 
BASE_NTH_LEVEL , 
BASE_SUBTREE, 
BASE ALL 



/** 

* SearchControl controls the f ind_managed_object search, 

* and contains ; 

* the type of scope ("type" field) , 

* the level of scope ("level" field) , level means the "baseObject" 

* level 1 means baseobject including its sub-ordinates etc.. 

* the filter ("filter" field), 

* the result type ("contents" field) . 

* The type, level and contents fields are all mandatory. 

* The filter field contains the filter expression. 

* The string "TRUE" indicates "no filter", 
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* i.e. a filter that matches everything. 
*/ 
struct SearchControl 

{ 

ScopeType type; 
unsigned long level; 
Filter filter_; 

ResultContents contents ; 



struct Result 



GenericIRPManagementConstDef s : :DN mo; 
GenericIRPManagementConstDef s : :MOAttributeSet attributes; 



typedef sequence <Result> ResultSet; 



/ * * 



* AttributeErrorCategory defines the categories of errors, related to 

* attributes, that can occur during creation or modification of MOs . 
* 

* NO_SUCH_ATTRIBUTE : The specified attribute does not exist. 

* INVALID_ATTRIBUTE_VALUE : The specified attribute value is not valid. 

* MISSING_ATTRIBUTE_VALUE: An attribute value is required but none was 

* provided and no default value is defined for the attribute. 

* INvALID_MODIFY_OPERATOR: The specified modify operator is not valid 

* (e.g. operator ADD_VALUES applied to a non multi-valued attribute 

* or operator SET_TO_DEFAULT applied where no default value is defined) . 

* MODIFY_NOT_ALLOWED: The modification of the attribute is not allowed. 

* MODIFY_FAILED: The modification failed because of an unspecified reason. 
*/ 

enum AttributeErrorCategory 

{ 

NO_SUCH_ATTRIBUTE , 

I NVAL I D_ATTR I B UTEJVALUE , 

M I S S I NG_ATTR I BUTE JVAL UE , 

INVALID_MODIFY_OPERATOR, 

MODI FY_NOT_ALLOWED , 

MODIFY FAILED 



* DeleteErrorCategory defines the categories of errors that can occur 

* during deletion of MOs. 

* SUBORDINATE_OBJECT: The MO cannot be deleted due to subordinate MOs. 

* DELETE_NOT_ALLOWED : The deletion of the MO is not allowed. 

* DELETE_FAILED : The deletion failed because of an unspecified reason. 
*/ 

enum DeleteErrorCategory 

{ 

SUBORDINATE_OBJECT, 
DELETE_NOT_ALLOWED , 
DELETE FAILED 



/ * * 

* AttributeError represents an error, related to an attribute, that occured 

* during creation or modification of MOs. 

* It contains: 

* - the name of the indicted attribute ("name" field) , 

* - the category of the error ("error" field) , 

* - optionally, the indicted attribute value ("value" field), 

* - optionally, additional details on the error ("reason" field) . 
*/ 

struct AttributeError 

{ 

GenericIRPManagementConstDef s : :MOAttributeName name; 
AttributeErrorCategory error; 

GenericIRPManagementConstDef s : :MOAttributeValue value; 
string reason; 



typedef sequence <AttributeError> AttributeErrorSeq; 
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* DeleteError represents an error that occured during deletion of MOs . 

* It contains: 

* - the distinguished name of the indicted MO ( "object_name" field) , 

* - the category of the error ("error" field) , 

* - optionally, additional details on the error ("reason" field) . 
*/ 

struct DeleteError 

{ 

GenericIRPManagementConstDef s : :DN obj ect_name ; 
DeleteErrorCategory error; 
string reason; 

}; 

typedef sequence <DeleteError> DeleteErrorSeq; 

/** 

* ModifyAttributeErrors represents errors that occured during 

* modification of attributes of a MO. 

* It contains: 

* - the distinguished name of the indicted MO ( "object_name" field) , 

* - a sequence containing the attribute errors ("errors" field) . 
*/ 

struct ModifyAttributeErrors 

{ 

GenericIRPManagementConstDef s : :DN obj ect_name ; 
AttributeErrorSeq errors; 

}; 

typedef sequence <ModifyAttributeErrors> ModifyAttributeErrorsSeq; 

typedef sequence < GenericIRPManagementConstDef s : :MOAttributeName> AttributeNameSet ; 

/** 

* ModifyOperator defines the way in which an attribute value is to be 

* applied to an attribute in a modification of MO attributes. 
* 

* REPLACE: replace the current value with the provided value 

* ADD_VALUES : for a multi-valued attribute, add the provided values to the 

* current list of values 

* REMOVE_VALUES : for a multi-valued attribute, remove the provided values 

* from the current list of values 

* SETJTOJDEFAULT : set the attribute to its default value 
*/ 

enum ModifyOperator 

{ 

REPLACE, 
ADD_VALUES , 
REMOVE_VALUES , 
SET_TO_DEFAULT 

}; 

/** 

* AttributeModif ication defines an attribute value and the way it is to 

* be applied to an attribute in a modification of MO attributes. 

* It contains: 

* - the name of the attribute to modify ("name" field) , 

* - the value to apply to this attribute ("value" field), 

* - the way the attribute value is to be applied to the attribute 

* ("operator" field) . 
*/ 

struct AttributeModif ication 

{ 

GenericIRPManagementConstDef s : :MOAttributeName name; 
GenericIRPManagementConstDef s : :MOAttributeValue value; 
ModifyOperator operator; 

}; 

typedef sequence <AttributeModif ication> AttributeModif icationSet; 

}; 

#endif // BASIC CM IRP CONST DEFS IDL 
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A.3.3 IDL specification "BasicCMIRPSystem.idl" 

//File: BasicCMIRPSystem.idl 
iifndef _BASIC_CM_IRP_SYSTEM_IDL_ 
#define _BASIC_CM_IRP_SYSTEM_IDL_ 

#include <GenericIRPManagementSystem. idl> 
#include <GenericIRPManagementConstDef s . idl> 
#include <BasicCMIRPConstDef s . idl> 



// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module BasicCmlRPSystem 

{ 

exception IllegalFilterFormatException { 
string reason; 

}; 

exception IllegalDNFormatException { 
string reason; 

}; 

exception IllegalScopeTypeException { 
string reason; 

}; 

exception IllegalScopeLevelException { 
string reason; 

}; 

exception Undef inedMOException { 
string reason; 



exception Undef inedScopeExcept ion 
string reason; 



exception FilterComplexityLimit { 
string reason; 



exception DuplicateMO { } ; 

exception CreateNotAllowed { } ; 

exception ObjectClassMismatch {}; 

exception NoSuchObjectClass { 

BasicCMIRPConstDef s : :M0Class objectClass; 

}; 

exception ParentObjectDoesNotExist {}; 

/** 

* System otherwise fails to complete the operation. System can provide 

* reason to qualify the exception. The semantics carried in reason 

* is outside the scope of this IRP. 
*/ 

exception NextBasicCmlnformations { string reason; }; 

exception NextDeleteErrors { string reason; }; 

exception NextModifyErrors { string reason; }; 

exception DestroyException { string reason; }; 

exception GetBasicCmlRPVersion { string reason; }; 

exception GetBasicCmlRPOperationProf ile { string reason; }; 

exception GetBasicCmlRPNotif icationProf ile { string reason; }; 

exception FindManagedObjects { string reason; }; 

exception CreateManagedObject { string reason; }; 

exception DeleteManagedObjects { string reason; }; 

exception ModifyManagedObjects { string reason; }; 

/** 

The BasicCmlnformationlterator is used to iterate through a snapshot of 
Managed Object Information when IRPManager invokes f ind_managed_objects . 
IRPManager uses it to pace the return of Managed Object Information. 

IRPAgent controls the life-cycle of the iterator. However, a destroy 
operation is provided to handle the case where IRPManager wants to stop 
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the iteration procedure before reaching the last iteration. 

*/ 

interface BasicCmlnformationlterator 

{ 

/** 

This method returns between 1 and "how_many" Managed Object information. 
The IRPAgent may return less than "how_many" items even if there are 
more items to return. "how_many" must be non-zero. Return TRUE if there 
may be more Managed Object information to return. Return FALSE if there 
are no more Managed Object information to be returned. 

If FALSE is returned, the IRPAgent will automatically destroy the 
iterator. 

@parm how_many how many elements to return in the "f etched_elements" out 

parameter. 
Oparm f etched_elements the elements, 
©returns A boolean indicating if any elements are returned. 

"f etched_elements" is empty when the BasicCmlnformationlterator is 

empty . 
*/ 

boolean next_basic_cm_informations ( 

in unsigned short how_many, 

out BasicCMIRPConstDef s : :ResultSet f etched_elements 
) 
raises ( 

NextBasicCmlnf ormations , 

GenericIRPManagementSystem: : InvalidParameter, 

GenericIRPManagementSystem: :OperationNotSupported) ; 

/** 

This method destroys the iterator. 

*/ 

void destroy () 

raises { 

DestroyException, 

GenericIRPManagementSystem: :OperationNotSupported) ; 

} ; // end of BasicCmlnformationlterator 

/** 

The DeleteResultlterator is used to iterate through the list of deleted MOs 

when IRPManager invokes method "delete_managed_objects" . 

IRPManager uses it to pace the return of Managed Object Information. 

IRPAgent controls the life-cycle of the iterator. However, a destroy 

operation is provided to handle the case where IRPManager wants to stop 

the iteration procedure before reaching the last iteration. 

*/ 

interface DeleteResultlterator ; BasicCmlnformationlterator 

{ 

/** 

Inherited method "next_basic_cm_informations" has the same behaviour as 
for interface BasicCmlnformationlterator, except that: 

- The Managed Object information returned in parameter 

"f etched_elements" contains only the DNs of the deleted MOs 
(no attributes are returned) . 

- If FALSE is returned, the IRPAgent will not automatically destroy the 
iterator. 

*/ 

/** 

This method returns between and "how_many" deletion errors. The 
IRPAgent may return less than "how_many" items even if there are more 
items to return. "how_many" must be non-zero. Return TRUE if there are 
more deletion errors to return. Return FALSE if there are no more 
deletion errors to be returned. 

If FALSE is returned and last call to inherited method 

"next_basic_cm_informations" also returned FALSE (i.e. no more Managed 
Object information to be returned), the IRPAgent will automatically 
destroy the iterator. 

Oparm how_many: how many deletion errors to return in the 

"f etched_delete_errors" out parameter. 
Oparm f etched_delete_errors : the deletion errors, 
©returns: a boolean indicating if any deletion errors are returned. 
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*/ 

boolean next_delete_errors ( 

in unsigned short how_many, 

out BasicCMIRPConstDef s : : DeleteErrorSeq f etched_delete_errors 
) 
raises { 

NextDeleteErrors , 

GenericIRPManagementSystem: ; InvalidParameter) ; 

} ; // end of DeleteResultlterator 

/** 

The ModifyResultlterator is used to iterate through the list of modified 
MOs when IRPManager invokes method "modify_managed_objects" . 
IRPManager uses it to pace the return of Managed Object Information. 

IRPAgent controls the life-cycle of the iterator. However, a destroy 

operation is provided to handle the case where IRPManager wants to stop 

the iteration procedure before reaching the last iteration. 

*/ 

interface ModifyResultlterator : BasicCmlnformationlterator 

{ 

/** 

Inherited method "next_basic_cm_informations" has the same behaviour as 
for interface BasicCmlnformationlterator, except that: 

- The Managed Object information returned in parameter 

"f etched_elements" contains DNs and attributes of the modified MOs. 

- If FALSE is returned, the IRPAgent will not automatically destroy the 
iterator. 

*/ 

/** 

This method returns between and "how_many" modification errors. The 
IRPAgent may return less than "how_many" items even if there are more 
items to return. "how_many" must be non-zero. Return TRUE if there are 
more modification errors to return. Return FALSE if there are no more 
modification errors to be returned. 

If FALSE is returned and last call to inherited method 

"next_basic_cm_informations" also returned FALSE (i.e. no more Managed 
Object information to be returned), the IRPAgent will automatically 
destroy the iterator. 

Oparm how_many: how many modification errors to return in the 

"f etched_modify_errors" out parameter. 
Oparm f etched_modify_errors : the modification errors. 

©returns: a boolean indicating if any modification errors are returned. 
*/ 

boolean next_modif icationerrors ( 

in unsigned short how_many, 

out BasicCMIRPConstDef s : :ModifyAttributeErrorsSeq 
f etched_modify_errors 
) 
raises { 

NextModif yErrors , 

GenericIRPManagementSystem: : InvalidParameter) ; 

} ; // end of ModifyResultlterator 

/** 

* The BasicCmlrpOperations interface. 

* Supports a number of Resource Model versions. 
*/ 

interface BasicCmlrpOperations : GenericIRPManagementSystem: : 
Generic IRPManagement 



Performs a containment search, using a SearchControl to 
control the search and the returned results. 

All MOs in the scope constitute a set that the filter works on. 
The result BasicCmlnformationlterator contains all matched MOs, 
with the amount of detail specified in the SearchControl. 
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* For the special case when no managed objects are matched in 

* f ind_managed_objects, the BasicCmlnf ormationlterator will be returned. 

* Executing the next_basicCmInformations in the 

* BasicCmlnformationlterator will return FALSE for 

* completion. 
* 

* ©parm base_object The start MO in the containment tree. 

* ©parm search_control the SearchControl to use . 

* Oparm requested_attributes defines which attributes to get. 

* If this parameter is empty ("") , all attributes shall 

* be returned. In this version this is the only supported semantics. 

* Note that this argument is only 

* relevant if ResultContents in the search control is 

* specif ed to NAMES_AND_ATTRIBUTES . 

* ©raises GenericIRPManagementSystem: ; ValueNotSupported if a valid but 

* unsupported parameter value is passed. E.g. the contents 

* field in the searchcontrol parameter contains the value NAMES and 

* the optional getContainment IS operation is not supported. 

* ©raises Undef inedMOException The MO does not exist. 

* ©raises IllegalDNFormatException The dn syntax string is 

* malformed. 

* ©raises IllegalScopeTypeException The ScopeType in scope contains 

* an illegal value. 

* ©raises IllegalScopeLevelException The scope level is negative 

* <<0) . 

* ©raises IllegalFilterFormatException The filter string is 

* malformed. 

* ©raises FilterComplexityLimit if the filter syntax is correct, 

* but the filter is too complex to be processed by the IRPAgent . 

* ©see SearchControl 

* ©see BasicCmlnformationlterator 
*/ 

BasicCmlnformationlterator f ind_managed_objects ( 

in GenericIRPManagementConstDef s : :DN base_object, 

in BasicCMIRPConstDef s :: SearchControl searchcontrol , 

in BasicCMIRPConstDef s ; : AttributeNameSet requested_attributes) 
raises { 

FindManagedOb j ects , 



ParameterNotSupported, 
InvalidParameter, 
ValueNotSupported, 
OperationNot Supported, 



GenericIRPManagementSystem: 

GenericIRPManagementSystem: 

GenericIRPManagementSystem: 

GenericIRPManagementSystem: 

Unde f inedMOExcept ion , 

IllegalDNFormatException, 

Undef inedScopeExcept ion, 

IllegalScopeTypeException, 

IllegalScopeLevelException, 

IllegalFilterFormatException, 

FilterComplexityLimit) ; 



* Performs the creation of a MO instance in the MIB maintained 

* by the IRPAgent . 

* ©parm object_name: the distinguished name of the MO to create. 

* ©parm ref erence_object : the distinguished name of a reference MO. 

* ©parm attributes: in input, initial attribute values for the MO to 

* create; in output, actual attribute values of the created MO. 

* ©parm attribute_errors : errors, related to attributes, that caused the 

* creation of the MO to fail. 
* 

* ©raises GenericIRPManagementSystem: :OperationNotSupported: The operation 

* is not supported. 

* ©raises GenericIRPManagementSystem: : ParameterNotSupported: An optional 

* parameter is not supported. 

* ©raises GenericIRPManagementSystem: : InvalidParameter : An invalid 

* parameter value has been provided. 

* ©raises Undef inedMOException: The MO does not exist. 

* ©raises IllegalDNFormatException: The DN syntax string is malformed. 

* ©raises DuplicateMO: A MO already exist with the same DN as the one 

* to create . 

* ©raises CreateNotAllowed: The creation of the MO is not allowed. 

* ©raises ObjectClassMismatch: The object class of the MO to create does 

* not match with the object class of the provided reference MO. 

* ©raises NoSuchObjectClass : The class of the object to create is not 

* recognized. 

* ©raises ParentObjectDoesNotExist : The parent MO instance of the 
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* ManagedEntity specified to be created does not exist. 
*/ 
void create_managed_object ( 

in GenericIRPManagementConstDef s : :DN object_name, 
in GenericIRPManagementConstDef s : :DN ref erence_object , 
inout GenericIRPManagementConstDef s : :MOAttributeSet attributes, 
out BasicCMIRPConstDef s ; : AttributeErrorSeq attribute_errors 
) 



OperationNot Supported, 
ParameterNotSupported, 
InvalidParameter, 



raises { 

CreateManagedOb j ect , 

GenericIRPManagementSystem: 

GenericIRPManagementSystem: 

GenericIRPManagementSystem: 

Undef inedMOException, 

I llegalDNFormat Except ion, 

DuplicateMO, 

CreateNotAl lowed, 

Obj ectClassMismatch, 

NoSuchObj ectClass , 

ParentObjectDoesNotExist) ; 

/** 

* Performs the deletion of one or more MO instances from the MIB 

* maintained by the IRPAgent, using a SearchControl to control the 

* instances to be deleted. 
* 

* All MOs in the scope constitute a set that the filter works on. 

* All matched MOs will be deleted by this operation. 

* The returned DeleteResultlterator is used to retrieve the DNs of the 

* MOs deleted and the errors that may have occurred preventing deletion 

* of some MOs . 

* For the special case when no managed objects are matched in 

* delete_managed_objects, the DeleteResultlterator will be returned. 

* Executing the next_basicCmInformations in the DeleteResultlterator 

* will return FALSE for completion. 
* 

* ©parm base_object: the start MO in the containment tree. 

* ©parm search_control : the SearchControl to use; field "contents" has no 

* meaning here and shall be ignored. 

* ©returns : a DeleteResultlterator (see above) . 
* 

* ©raises GenericIRPManagementSystem: :OperationNotSupported: The operation 

* is not supported. 

* ©raises GenericIRPManagementSystem: : InvalidParameter : An invalid 

* parameter value has been provided. 

* ©raises Undef inedMOException: The MO does not exist. 

* ©raises IllegalDNFormatException: The DN syntax string is malformed. 

* ©raises IllegalScopeTypeException: The ScopeType in scope contains 

* an illegal value. 

* ©raises IllegalScopeLevelException: The scope level is negative (<0) . 

* ©raises IllegalFilterFormatException: The filter string is malformed. 

* ©raises FilterComplexityLimit : The filter syntax is correct, 

* but the filter is too complex to be processed by the IRPAgent. 
*/ 

DeleteResultlterator delete_managed_objects ( 

in GenericIRPManagementConstDef s : :DN base_object, 

in BasicCMIRPConstDef s :: SearchControl searchcontrol 
) 
raises { 

DeleteManagedOb j ects , 

GenericIRPManagementSystem: : OperationNot Supported, 

GenericIRPManagementSystem: : InvalidParameter, 

Unde f inedMO Except ion , 

IllegalDNFormatException, 

Undef inedScopeExcept ion, 

IllegalScopeTypeException, 

IllegalScopeLevelException, 

IllegalFilterFormatException, 

FilterComplexityLimit) ; 



/* 



Performs the modification of MO attributes. One or more MOs attributes 
may be modified according to a SearchControl. 

All MOs in the scope constitute a set that the filter works on. 
All matched MOs will have their attributes modified by this operation. 
The returned ModifyResultlterator is used to retrieve the DNs of the 
modified MOs together with the values of the modified attributes, and 
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* the errors that may have occurred preventing modification of some 

* attributes. 

* For the special case when no managed objects are matched in 

* modify_managed_objects, the ModifyResultlterator will be returned. 

* Executing the next_basicCmInf ormations in the ModifyResultlterator 

* will return FALSE for completion. 
* 

* ©parm base_object: the start MO in the containment tree. 

* ©parm search_control : the SearchControl to use; field "contents" has no 

* meaning here and shall be ignored. 

* ©parm modifications: the values for the attributes to modify and 

* the way those values are to be applied to the attributes. 

* ©returns : a ModifyResultlterator (see above) . 
* 

* ©raises GenericIRPManagementSystem: :OperationNotSupported: The operation 

* is not supported 

* ©raises GenericIRPManagementSystem: ; InvalidParameter : An invalid 

* parameter value has been provided 

* ©raises Undef inedMOException: The MO does not exist. 

* ©raises IllegalDNFormatException: The DN syntax string is malformed. 

* ©raises IllegalScopeTypeException: The ScopeType in scope contains 

* an illegal value. 

* ©raises IllegalScopeLevelException: The scope level is negative (<0) . 

* ©raises IllegalFilterFormatException: The filter string is malformed. 

* ©raises FilterComplexityLimit : The filter syntax is correct, 

* but the filter is too complex to be processed by the IRPAgent . 
*/ 

ModifyResultlterator modify_managed_objects ( 

in GenericIRPManagementConstDef s : :DN base_object, 

in BasicCMIRPConstDef s :: SearchControl search_control, 

in BasicCMIRPConstDef s : : AttributeModif icationSet modifications 
) 
raises { 

Modif yManagedOb j ects , 

GenericIRPManagementSystem: :OperationNot Supported, 

GenericIRPManagementSystem: : InvalidParameter, 

Unde f inedMO Except ion , 

IllegalDNFormatException, 

Undef inedScopeExcept ion, 

IllegalScopeTypeException, 

IllegalScopeLevelException, 

IllegalFilterFormatException, 

FilterComplexityLimit) ; 



#endif // BASIC CM IRP SYSTEM IDL 
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Annex B (normative): 
SOAP Solution Set 



This annex specifies the SOAP Solution Set for the IRP whose semantics are specified in 3GPP TS 32.602 [8]. 

B.1 Architectural features 

The overall architectural feature of Basic Configuration Management IRP is specified in 3GPP TS 32.602 [8]. 
This clause specifies features that are specific to the SOAP SS. 

B.1 .1 Syntax for Distinguished Names and Versions 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [3]. 
The version of this IRP is represented as a string (see also clause 3.1). 

B.1 .2 Supported W3C specifications 

The SOAP 1.1 specification [11] and WSDL 1.1 specification [12] are supported. 

The SOAP 1.2 specification [14] is supported optionally. 

This specification uses "document" style in the WSDL description. 

This specification uses "literal" encoding style in the WSDL description. 

B.1 .3 Prefixes and namespaces 

This specification uses a number of namespace prefixes throughout that are listed in Table B.1. 3. 
Table B.1. 3: Prefixes and Namespaces used in this specification 



Prefix 


Namespace 


http 


http://schemas.xmlsoap.org/wsdl/http/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


SOAP-ENV 


http://schemas.xmlsoap.org/soap/envelope/ 


SOAP-ENC or 
soapenc 


http://schemas.xmlsoap.org/soap/encoding/ 


xs or xsd 


http://www.w3.org/2001/XMLSchema 


xsi 


http://www.w3.org/2001/XMLSchema-instance 


basicCMIRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32606#BasicCMIRPSystem 


basicCMIRPData 


http://www.3gpp.org/ftp/specs/archive/32 series/32606#BasicCMIRPData 


genericlRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/3231 6#GenericlRPSystem 



B.1. 4 Filter language 



The filter language used in the SS is the XPath Language (see W3C XPath 1.0 specification [13]). IRP Agents may 
throw a FilterComplexityLimit fault when a given filter is too complex. 
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B.2 Mapping 

B.2.1 General mappings 

The IS parameter name managedObjectlnstance is mapped into DN. 

Attributes modelling associations as defined in the NRM (here also called "reference attributes") are in this SS mapped 
to attributes. The names of the reference attributes in the NRM are mapped to the corresponding attribute names in the 
MOC. When the cardinality for an association is 0..1 or 1..1 the datatype for the reference attribute is defined as a 
MOReference. The value of an MO reference contains the distinguished name of the associated MO. When the 
cardinality for an association allows more than one referred MO, the reference attribute will be of type 
MOReferenceSet, which contains a sequence of MO references. 

If a reference attribute is changed, an AttributeValueChange notification (see 3GPP TS 32.666 [9]) is emitted. 



B.2. 2 Operation mapping 



The Basic CM IRP: IS (see 3GPP TS 32.602 [8]) defines semantics of operation visible across the Basic Configuration 
Management IRP. Table B.2. 2 indicates mapping of these operations to their equivalents defined in this SS. 

Table B.2. 2: Mapping from IS Operation to SS equivalents 



IS Operation 
(3GPP TS 32.602 [8]) 


SS Operation 


Qualifier 


getMoAttributes 


getMOAttributes 


M 


getContainment 


getContainment 


O 


cancelOperation (see note 1 ) 


N/A 


N/A 


createMO 


createMO 


O 


deleteMO 


deleteMO 


O 


setMOAttributes 


setMOAttributes 


O 


getlRPVersion (see note 2) 


getlRPVersion 


M 


getOperationProfile (see note 2) 


getOperationProfile 


O 


getNotificationProfile (see note 2) 


getNotificationProfile 


O 


NOTE 1 : This operation is NOT mapped because it"s useful for one-request-and-multiple-responses operations, which 

are not used in this Solution Set. 
NOTE 2: This operation is of IOC ManagedGenericIRP specified in [6]. The IOC BasicCmIRP of [8] inherits from it. 
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B.2.3 Operation parameter mapping 

The Basic CM IRP: IS (see 3GPP TS 32.602 [8]) defines semantics of parameters carried in operations across the Basic 
Configuration Management IRP. The following tables show the mapping of these parameters, as per operation, to their 
equivalents defined in the present document. 

B.2.3. 1 Operation getMoAttributes 

B.2.3. 1 .1 Input parameters 

Mapping from IS getMoAttributes input parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


invokeldentifierln 


string invokeldentifierln 


M 


baseObjectlnstance, 

scope, 

filter, 

attributeListln 


string query Xpath Exp 


M 



Here is the XML schema fragment of the getMO Attributes request: 

<!-- getMOAttributes Request --> 
<element name=" getMOAttributes" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="invokeIdentif ierln" type="string"/> 
<element name="queryXpathExp" type="string"/> 

</sequence> 
</complexType> 
</element> 



B.2.3. 1 .2 Output parameters 



Mapping from IS getMoAttributes output parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


invokeldentifierOut 


string invokeldentifierOut 


M 


managedObjectClass, 

managedObjectlnstance, 

attributeListOut 


basicCMIRPData:MOSequenceType moiListOut 


M 


status 


basicCMIRPData:getMOAttributesFault 


M 



The specific 'attributeListOut' definition depends on the corresponding NRM XML definition. 
Here is the XML schema fragment of the getMOAttributes response: 

<!-- getMoAttributes Response --> 

<element name="getMoAttributesResponse" > 
<complexType> 
<sequence> 

<element name=" invokeldentifierOut" type="string"/> 

<<element name= "moiListOut" type="basicCMIRPData :MOSequenceType"/>/sequence> 
</complexType> 
</element> 
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B.2.3.1.3 Fault definition 

<!-- getMoAttributes Fault --> 

<element name="getMOAttributesFault" > 
< c omp 1 exTyp e > 
<choice> 

<element name="getMOAttributesFault" type="string"/> 
<element name="resourceLimitationFault" type="string"/> 
<element name="operationCancelledFault" type="string"/> 
<element name="complexityLimitationFault" type="string"/> 
< element ref ="basicCMIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

B.2.3.2 Operation getContainment 

B. 2. 3. 2.1 Input parameters 

Mapping from IS getContainment input parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


invokeldentifierln 


string invokeldentifierln 


M 


baseObjectlnstance, 
scope 


string query Xpath Exp 


M 



Here is the XML schema fragment of the getContainment request: 

<!-- getContainment Request --> 
<element name=" getContainment" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="invokeIdentif ierln" type="string"/> 
<element name="queryXpathExp" type="string"/> 
</sequence> 
</complexType> 
</element> 



B.2.3.2.2 Output parameters 



Mapping from IS getContainment output parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


invokeldentifierOut 


string invokeldentifierOut 


M 


containment 


string topContainerLoc 


M 


status 


basicCMIRPData:getContainmentFault 


M 



Here is the XML schema fragment of the getContainment response: 



!-- getContainment Response --> 
<element name="getContainmentResponse" > 
< c omp 1 exTyp e > 
<sequence> 

<element name=" invokeldentifierOut" type="string"/> 
<element name="topContainerLoc" type="string"/> 

<!--each element contains only id attribute and other MO it contains 
<any minOccurs="0" maxOccurs= " unbounded" / > 
</sequence> 
</complexType> 
</element> 
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B.2.3.2.3 Fault definition 

<!-- getContainment Fault --> 

<element name="getContainmentFault" > 
< c omp 1 exTyp e > 
<choice> 

<element name="getContainmentFault" type="string"/> 
<element name="resourceLimitationFault" type="string"/> 
<element name="operationCancelledFault" type="string"/> 
<element name="complexityLimitationFault" type="string"/> 
< element ref ="basicCMIRPData :OperationNotSupportedFault"/> 
<element ref ="basicCMIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

B.2.3.3 Operation createMO 

B. 2. 3. 3.1 Input parameters 

Mapping from IS createMO input parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managedObjectClass, 
managedObjectlnstance 


string mOIEIementLoc 


M 


referenceObjectlnstance 


string referenceObjectlnstance 


O 


attributeListln 


basicCMIRPData:AnyMOType mO 


M 



The specific 'attributeListln' definition depends on the corresponding NRM XML definition. 
Here is the XML schema fragment of the createMO request: 



'.-- createMO Request --> 
<element name= " createMO" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="mOIElementLoc" type="string"/> 
<element name="ref erenceObjectlnstance" type="string" 
<element name="mO" type="basicCMIRPData :AnyMOType"/> 
</sequence> 
</complexType> 
</element> 



minOccurs=" 0"/> 



B.2.3.3.2 



Output parameters 

Mapping from IS createMO output parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


attributeListOut 


basicCMIRPData:AnyMOType mO 


M 


status 


basicCMIRPData:createMOFault 


M 



The specific 'attributeListOut' definition depends on the corresponding NRM XML definition. 
Here is the XML schema fragment of the createMO response: 

<!-- createMO Response --> 

< element name="createMOResponse"> 
< c omp 1 exTyp e > 
<sequence> 

<element name="mO" type="basicCMIRPData :AnyMOType"/> 
</sequence> 
</complexType> 
</element> 
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B.2.3.3.3 Fault definition 

<!-- createMO Fault --> 

<element name="createMOFault"> 
< c omp 1 exTyp e > 
<choice> 

<element name="createMOFault" type="string"/> 

< element name="objectClassSpecif icationMissmatchedFault" type=" string" /> 

<element name="InvalidObjectInstanceFault" type="string"/> 

<element name="createNotAllowedFault" type="string"/> 

<element name="noSuchObjectClassFault" type="string"/> 

<element name="classInstanceConf lictFault" type="string"/> 

<element name="noSuchAttributeFault" type="string"/> 

<element name="invalidAttributeValueFault" type="string"/> 

<element name="missingAttributeValueFault" type="string"/> 

< element name ="parentObjectDoesNot Exist Fault" type=" string" /> 

< element re f ="basicCMIRPDat a :OperationNot Support edFault" /> 

< element ref ="basicCMIRPData : InvalidParameterFault" /> 
</choice> 
</complexType> 
</element> 

B.2.3.4 Operation deleteMO 

B. 2. 3.4.1 Input parameters 

Mapping from IS deleteMO input parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


baseObjectlnstance, 

scope, 

filter 


string query Xpath Exp 


M 



Here is the XML schema fragment of the deleteMO request: 

<!-- deleteMO Request --> 
<element name="deleteMO" > 
<complexType> 
<sequence> 

<element name="queryXpathExp" type="string"/> 
</sequence> 
</complexType> 
</element> 



B.2.3.4.2 



Output parameters 

Mapping from IS deleteMO output parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


deletionList 


basicCMIRPData:MOSequenceTypedeletionl_ist 


M 


status 


basicCMIRPData:deleteMOFault 


M 



Here is the XML schema fragment of the deleteMO response: 

<!-- deleteMO Response --> 

< element name="deleteMOResponse"> 
< c omp 1 exTyp e > 
<sequence> 

<element name="deletionList" type="basicCMIRPData :MOSequenceType" > 
</element> 

</sequence> 
</complexType> 
</element> 
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B.2.3.4.3 Fault definition 

<!-- deleteMO Fault --> 

<element name="deleteMOFault"> 
< c omp 1 exTyp e > 
<choice> 

<element name="deleteMOFault" type="string"/> 
<element name="invalidObjectInstanceFault" type="string"/> 
<element name="deleteNotAllowedFault" type="string"/> 
<element name="resourceLimitationFault" type="string"/> 
<element name="complexityLimitationFault" type="string"/> 
<element ref ="basicCMIRPData :OperationNotSupportedFault"/> 
<element ref ="basicCMIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

B.2.3.5 Operation setMOAttributes 

B. 2. 3. 5.1 Input parameters 

Mapping from IS setMOAttributes input parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


baseObjectlnstance, 

scope, 

filter, 

modificationList 


stringqueryXpathExp 


M 


modification List 


basicCMIRPData:AttributeModificationSetType modificationList 


M 



Here is the XML schema fragment of the setMOAttributes request: 

<!-- setMOAttributes Request --> 
<element name=" setMOAttributes" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="queryXpathExp" type="string"/> 
< element name= "modificationList" 

type="basicCMIRPData:AttributeModif icationSetType"/> 
</sequence> 
</complexType> 
</element> 

<complexType name= ' AttributeModif icationSetType ' > 
<sequence> 

<element name= "AttributeModif ication" maxOccurs= "unbounded" > 
<complexType> 
<sequence> 
<any/> 

<element name="operator" type= ' basicCMIRPData :ModifyOperatorType ' /> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</complexType> 

<simpleType name="ModifyOperatorType"> 
<restriction base="string" > 

<enumeration value="REPLACE"/> 
<enumeration value="ADDValues"/> 
<enumeration value="REMOVEValues"/> 
< enumeration value="SETToDef ault" /> 
</restriction> 
</simpleType> 
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B.2.3.5.2 Output parameters 

Mapping from IS setMOAttributes output parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


modificationListOut 


basicCMIRPData:MOSequenceTypemodificationListOut 


M 


status 


basicCMIRPData:setMOAttributesFault 


M 



Here is the XML schema fragment of the setMOAttributes response: 



!-- setMOAttributes Response --> 
<element name="setMOAttributesResponse" > 
< c omp 1 exTyp e > 
<sequence> 

<element name= "modificationListOut" 
</sequence> 
</complexType> 
</element> 



type="basicCMIRPData:MOSequenceType"/; 



B.2.3.5.3 



Fault definition 



!-- setMOAttributes Fault --> 
<element name="setMOAttributesFault" > 
<complexType> 
<choice> 

<element 
< element 
< element 
< element 
<element 
<element 
<element 
<element 
<element 
</choice> 
</complexType> 
</element> 



name= " setMOAttributesFault " type= " string" / > 
name="modifyNotAllowedFault" type=" string" /> 
name="noSuchAttributeFault" type=" string" /> 
name= " invalidAttributeValueFault " type= " string" / > 
name="missingAttributeValueFault" type=" string" /> 
name= " resourceLimitat ionFault " type= " string" / > 
name= " complexityLimi tat ionFault " type= " string" / > 
re f ="basicCMIRPDat a: OperationNot Support edFault" /> 
ref="basicCMIRPData: InvalidParameterFault" /> 
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B.3 Solution Set definitions 
B.3.1 WSDL definition structure 

Clause B.3. 2 provides a graphical representation of the Basic CM IRP service. 
Clause B.3. 3 defines the services which are supported the Basic CM IRP agent. 

B.3. 2 Graphical Representation 

The WSDL structure is presented in Figure B.3. 2: 



Operations 




PortTypes 




Bindings 




Services 


H-^ getlRPVersion 
H™^ getOperationProfile 
H-^ getNotificationProfile 
H-^ getMO Attributes 
EH- ^ getContainment 
\±\~+i createMO 
H-+S deleteMO 
EE-^ setMOAttributes 










0-®= BasicCMIRP 


^L_ 


E-<£) BasicCMIRP 
> % BasicCMIRP 










| 









Figure B.3.2: BasicCM IRP SOAP Solution Set WSDL structure 
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B.3.3 WSDL specification 'BasicCMIRPSystem.wsdl' 

<?xml version=" 1 . 0" encoding="UTF-8" ?> 

<def initions xmlns="http : //schemas .xmlsoap . org/wsdl/" 

xmlns : soap="http : //schemas .xmlsoap.org/wsdl/soap/" 

xmlns :http="http : //schemas .xmlsoap .org/wsdl/http/" xmlns :xs="http : //www. w3 . org/2 01/XMLSchema" 

xmlns : soapenc="http : //schemas .xmlsoap .org/ soap/ encoding/" 

xmlns :basicCMIRPSystem="http: //www. 3gpp .org/ ftp/ specs /archive/ 3 2_series/3 2 . 6 6#BasicCMIRPSystem" 

xmlns :basicCMIRPData="http: //www. 3gpp.org/ftp/specs/archive/32_series/32 . 6 6#BasicCMIRPData" 

xmlns :genericIRPSystem="http : //www. 3gpp . org/ ftp/ specs /archive/3 2_series/3 2 . 316#GenericIRPSystem" 

targe tName space ="http : //www. 3gpp . org/ f tp/ specs /archive/3 2_series/3 2 . 6 6#BasicCMIRPSystem" > 

< import namespace="http : //www. 3gpp . org/ f tp/ specs /archive/3 2_series/3 2 . 316#GenericIRPSystem"/> 
<types> 

< schema 
targe tName space="http : //www. 3gpp . org/f tp/ specs /archive/3 2_series/3 2 . 60 6#BasicCMIRPData" 
xmlns="http: //www.w3 . org/2 1/XMLSchema " > 

<!-- getMOAttributes Request --> 
<element name=" getMOAttributes" > 
<complexType> 
<sequence> 

<element name="invokeIdentif ierln" type="string"/> 
<element name="queryXpathExp" type="string"/> 
</sequence> 
</complexType> 
</element> 

<!-- getMOAttributes Response --> 
<element name="getMoAttributesResponse" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="invokeIdentif ierOut" type="string"/> 

<element name="moiListOut" type="basicCMIRPData :M0SequenceType"/> 
</sequence> 
</complexType> 
</element> 

<complexType name= "AnyMOType " > 
<sequence> 

<!--M0 instance location in XPath expression- -> 
<element name="moiLocation" type="string"/> 
< ! --each M0--> 
<any/> 
</sequence> 
</complexType> 

<complexType name="MOSequenceType" > 
<sequence> 

<element name="mo" type="basicCMIRPData :AnyM0Type" min0ccurs=" 0" 
maxOccur s= " unbounded " / > 

</sequence> 
</complexType> 

<!-- getMOAttributes Fault --> 
<element name="getMOAttributesFault" > 
< c omp 1 exTyp e > 
<choice> 

<element name="getMOAttributesFault" type="string"/> 
<element name="resourceLimitationFault" type="string"/> 
<element name="operationCancelledFault" type="string"/> 
<element name="complexityLimitationFault" type="string"/> 
<element ref ="basicCMIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

<!-- getContainment Request --> 
<element name=" getContainment" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="invokeIdentif ierln" type="string"/> 
<element name="queryXpathExp" type="string"/> 
</sequence> 
</complexType> 
</element> 

<!-- getContainment Response --> 
<element name="getContainmentResponse" > 
< c omp 1 exTyp e > 
<sequence> 

<!--top container element xpath location --> 
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<element name="invokeIdentif ierOut" type="string"/> 
<element name="topContainerLoc" type="string"/> 

<!--each element contains only id attribute and other MO it contains --> 
<any minOccurs="0" maxOc curs = " unbounded " / > 
</sequence> 
</complexType> 
</element> 

<!-- getContainment Fault --> 
<element name="getContainmentFault" > 
< c omp 1 exTyp e > 
<choice> 

<element name="getContainmentFault" type="string"/> 
<element name="resourceLimitationFault" type="string"/> 
<element name="operationCancelledFault" type="string"/> 
<element name="complexityLimitationFault" type="string"/> 
<element ref ="basicCMIRPData :OperationNotSupportedFault"/> 
< element ref ="basicCMIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

<!-- createMO Request --> 
<element name= " createMO" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="mOIElementLoc" type=" string" /> 

<element name="ref erenceObjectlnstance" type=" string" minOccurs=" 0"/> 
<element name="mO" type="basicCMIRPData :AnyMOType"/> 
</sequence> 
</complexType> 
</element> 

<!-- createMO Response --> 
< element name="createMOResponse"> 
<complexType> 
<sequence> 

<element name="mO" type="basicCMIRPData :AnyMOType"/> 
</sequence> 
</complexType> 
</element> 

<!-- createMO Fault --> 
<element name="createMOFault"> 
< c omp 1 exTyp e > 
<choice> 

<element name="createMOFault" type="string"/> 

< element name="objectClassSpecif icationMissmatchedFault" type=" string" /> 
<element name="InvalidObjectInstanceFault" type="string"/> 
<element name="createNotAllowedFault" type="string"/> 
<element name="noSuchObjectClassFault" type="string"/> 
<element name="classInstanceConf lictFault" type="string"/> 
<element name="noSuchAttributeFault" type="string"/> 
<element name="invalidAttributeValueFault" type="string"/> 
<element name="missingAttributeValueFault" type="string"/> 
< element name="parentObjectDoesNot Exist Fault" type=" string" /> 
< element ref ="basicCMIRPData :OperationNotSupportedFault"/> 
< element ref ="basicCMIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

<!-- deleteMO Request --> 
<element name="deleteMO" > 
<complexType> 
<sequence> 

<element name="queryXpathExp" type="string"/> 
</sequence> 
</complexType> 
</element> 

<!-- deleteMO Response --> 
< element name="deleteMOResponse"> 
< c omp 1 exTyp e > 
<sequence> 

<element name="deletionList" type="basicCMIRPData :MOSequenceType" > 
</element> 
</sequence> 
</complexType> 
</element> 

<!-- deleteMO Fault --> 
<element name="deleteMOFault" > 
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<complexType> 
<choice> 

<element name="deleteMOFault" type="string"/> 
<element name="invalidObjectInstanceFault" type="string"/> 
<element name="deleteNotAllowedFault" type="string"/> 
<element name="resourceLimitationFault" type="string"/> 
<element name="complexityLimitationFault" type="string"/> 
<element ref ="basicCMIRPData :OperationNotSupportedFault"/> 
<element ref ="basicCMIRPData ; InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

<!-- setMOAttributes Request --> 
<element name=" setMOAttributes" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="queryXpathExp" type="string"/> 
< element name =" modi f icationList" 
type="basicCMIRPData:AttributeModif icationSetType" /> 
</sequence> 
</complexType> 
</element> 

<simpleType name="ModifyOperatorType" > 
<restriction base="string" > 

enumeration value="REPLACE"/> 
< enumeration value="ADDValues"/> 
enumeration value="REMOVEValues"/> 
< enumeration value="SETToDef ault"/> 
</restriction> 
</simpleType> 

<complexType name="AttributeModif icationSetType" > 
<sequence> 

<element name="AttributeModif ication" maxOccurs= "unbounded" > 
< c omp 1 exTyp e > 
<sequence> 
<any/> 

< element name=" operator" type="basicCMIRPData :ModifyOperatorType"/> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</complexType> 

<!-- setMOAttributes Response --> 
<element name="setMOAttributesResponse" > 
< c omp 1 exTyp e > 
<sequence> 

< element name="modif icationListOut" type="basicCMIRPData :MOSequenceType"/> 
</sequence> 
</complexType> 
</element> 

<!-- setMOAttributes Fault --> 
<element name="setMOAttributesFault" > 
< c omp 1 exTyp e > 
<choice> 

<element name="setMOAttributesFault" type="string"/> 
<element name="modifyNotAllowedFault" type="string"/> 
<element name="noSuchAttributeFault" type="string"/> 
<element name="invalidAttributeValueFault" type="string"/> 
<element name="missingAttributeValueFault" type="string"/> 
<element name="resourceLimitationFault" type="string"/> 
<element name="complexityLimitationFault" type="string"/> 
< element ref ="basicCMIRPData :OperationNotSupportedFault"/> 
<element ref ="basicCMIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

<element name="OperationNotSupportedFault" type="string"/> 
<element name="InvalidParameterFault" type="string"/> 
<simpleType name="VersionNumberType" > 

<restriction base="string"/> 
</simpleType> 

<complexType name="VersionNumberSetType" > 
<sequence> 

<element name="versionNumber" type="basicCMIRPData : VersionNumberType" 
maxOccur s= " unbounded " / > 

</sequence> 
</complexType> 
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■ccomplexType name="ParameterSetType" > 
<sequence> 

<element name = "parameterName " type=" string" maxOc curs = " unbounded " / > 
</sequence> 
</complexType> 

<complexType name="OperationType" > 
<sequence> 

<element name= " operat ionName " type="string"/> 

<element name= "parameterSet " type="basicCMIRPData : ParameterSetType"/> 
</sequence> 
</complexType> 

<complexType name="OperationSetType" > 
<sequence> 

<element name="operation" type="basicCMIRPData : Operat ionType" 
maxOc cur s = " unbounded " / > 

</sequence> 
</complexType> 

■ccomplexType name="Notif icationType" > 
<sequence> 

<element name="notif icationName" type="string"/> 

< element name = "parameterSet" type="basicCMIRPData ; ParameterSetType"/> 
</sequence> 
</complexType> 

<complexType name="Notif icationSetType" > 
<sequence> 

<element name="notif ication" type="basicCMIRPData :Notif icationType" 
maxOccur s= " unbounded " / > 

</sequence> 
</complexType> 
</schema> 
</types> 
<message name="getMOAttributesRequest" > 

<part name= "parameter" element="basicCMIRPData :getMOAttributes"/> 
</message> 
<message name="getMOAttributesResponse" > 

<part name= "parameter" element="basicCMIRPData :getMoAttributesResponse"/> 
</message> 
<message name="getMOAttributesFault" > 

<part name= "parameter" element="basicCMIRPData :getMOAttributesFault"/> 
</message> 
<message name="getContainmentRequest" > 

<part name= "parameter" element ="basicCMIRPDat a :getContainment"/> 
</message> 
<message name="getContainmentResponse" > 

<part name= "parameter" element="basicCMIRPData :getContainmentResponse"/> 
</message> 
<message name="getContainmentFault" > 

<part name= "parameter" element="basicCMIRPData :getContainmentFault"/> 
</message> 

■cmessage name = "createMORequest" > 

<part name= "parameter" element="basicCMIRPData : createMO"/> 
</message> 
<message name= "createMOResponse" > 

<part name= "parameter" element="basicCMIRPData : createMOResponse"/> 
</message> 
<message name="createMOFault"> 

<part name= "parameter" element="basicCMIRPData : createMOFault"/> 
</message> 
<message name="deleteMORequest" > 

<part name= "parameter" element="basicCMIRPData :deleteMO"/> 
</message> 
<message name="deleteMOResponse"> 

<part name= "parameter" element ="basicCMIRPDat a :deleteMOResponse"/> 
</message> 
<message name="deleteMOFault"> 

<part name= "parameter" element="basicCMIRPData :deleteMOFault"/> 
</message> 
<message name="setMOAttributesRequest" > 

<part name = "parameter" element="basicCMIRPData : setMOAttributes"/> 
</message> 
<message name="setMOAttributesResponse" > 

<part name= "parameter" element="basicCMIRPData : setMOAttributesResponse"/> 
</message> 
<message name="setMOAttributesFault" > 

<part name= "parameter" element ="basicCMIRPDat a : setMOAttributesFault" /> 
</message> 
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<portType name="BasicCMIRP" > 

■coperation name="getIRPVersion" > 

< input message="genericIRPSystem:getIRPVersionRequest"/> 

< output message="genericIRPSystem:getIRPVersionResponse"/> 

< fault name="getIRPVersionFault" message="genericIRPSystem:getIRPVersionFault"/> 

</operation> 

<operation name="getOperationProf ile"> 

< input message="genericIRPSystem:getOperationProf ileRequest"/> 
<output message="genericIRPSystem:getOperationProf ileResponse"/> 
< fault name="getOperationProf ileFault" 
message="genericIRPSystem:getOperationProf ileFault"/> 

</operation> 

<operation name="getNotif icationProf ile" > 

< input message=" genericIRPSystem:getNot if icationProf ileRequest"/> 
<output me ssage="genericIRPSyst em :getNotif icationProf ileResponse"/> 
< fault name="getNotif icationProf ileFault" 
me s sage =" genericIRPSystemigetNot if icationProf ileFault "/> 

</operation> 

<operation name="getMOAttributes"> 

< input message="basicCMIRPSystem:getMOAttributesRequest"/> 

<output message="basicCMIRPSystem:getMOAttributesResponse"/> 

< fault name="getMOAttributesFault" message="basicCMIRPSystem:getMOAttributesFault" /> 

</operation> 

<operation name="getContainment"> 

< input message="basicCMIRPSystem:getContainmentRequest"/> 

<output message="basicCMIRPSystem:getContainmentResponse"/> 

< fault name =" get Containment Fault" message="basicCMIRPSystem:getContainmentFault"/> 

</operation> 

<operation name="createMO" > 

<input message="basicCMIRPSystem: createMORequest"/> 

<output message="basicCMIRPSystem: createMOResponse"/> 

< fault name= " createMOFault " message= "basicCMIRPSystem : createMOFault " / > 

</operation> 

<operation name="deleteMO" > 

< input message= "basicCMIRPSystem :deleteMORequest"/> 

<output message="basicCMIRPSystem:deleteMOResponse"/> 

< fault name="deleteMOFault" message="basicCMIRPSystem:deleteMOFault" /> 

</operation> 

<operat ion name= " setMOAttributes " > 

<input message="basicCMIRPSystem: setMOAttributesRequest"/> 

<output me ssage= "basicCMIRPSystem: setMOAttributesResponse"/> 

<fault name="setMOAttributesFault" message= "basicCMIRPSystem: setMOAttributesFault" /> 

</operation> 
</portType> 

<binding name="BasicCMIRP" type= "basicCMIRPSystem : BasicCMIRP" > 

<soap : binding style=" document" transport="http : //schemas .xmlsoap .org/soap/http"/> 
<operation name="getIRPVersion" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/ specs /archive/ 3 2_series/3 2 . 606#getIRPVersion"/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
<f ault name="getIRPVersionFault" > 

<soap:fault name="getIRPVersionFault" use="literal"/> 
</f ault> 
</operation> 

<operation name="getOperationProf ile"> 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/ specs /archive/3 2_series/3 2 . 606#getOperationProf ile"/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
< fault name="getOperationProf ileFault "> 

<soap:fault name="getOperationProf ileFault" use="literal"/> 
</f ault> 
</operation> 

<operation name="getNotif icationProf ile" > 
<soap : operation 
soapAction="http : //www. 3gpp .org/f tp/ specs /archive/3 2_series/3 2 . 6 6#getNotif icationProf ile" /> 
< input > 
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<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
< fault name="getNotif icationProf ileFault"> 

<soap : fault name= "getNot if icationProf ileFault" use=" literal" /> 
</f ault> 
</operation> 

<operation name="getMOAttributes"> 
<soap : operation 
soapAction="http : //www. 3gpp . org/ f tp/ specs /archive/3 2_series/3 2 . 60 6#getMOAttributes"/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
< fault name="getMOAttributesFault" > 

<soap:fault name="getMOAttributesFault" use="literal"/> 
</fault> 
</operation> 

<operation name="getContainment"> 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/ specs /archive/3 2_series/3 2 . 6 6#getContainment"/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
< fault name="getContainmentFault"> 

<soap:fault name="getContainmentFault" use="literal"/> 
</fault> 
</operation> 

<operation name="createMO" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/ specs /archive/ 3 2_series/3 2 . 6 6#createMO"/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
< fault name="createMOFault" > 

<soap: fault name="createMOFault" use="literal"/> 
</f ault> 
</operation> 

<operation name="deleteMO" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/ specs /archive/ 3 2_series/3 2 . 6 6#deleteMO"/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
< fault name="deleteMOFault" > 

<soap: fault name="deleteMOFault" use="literal"/> 
</f ault> 
</operation> 

<operation name="setMOAttributes"> 
<soap : operation 
soapAction="http : //www. 3gpp .org/f tp/ specs /archive/3 2_series/3 2 . 60 6#setMOAttributes"/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
< fault name=" setMOAttributesFault" > 

<soap:fault name=" setMOAttributesFault" use="literal"/> 
</f ault> 
</operation> 
</binding> 
<service name="BasicCMIRP" > 

<port name="BasicCMIRP" binding="basicCMIRPSystem:BasicCMIRP" > 
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<soap : address 
location= "http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 6 06#BasicCMIRP"/> 
</port> 
</service> 
</def initions> 
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Annex C (informative): 
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- 
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